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-TITLE DOISMNTDSP = DISMOUNT system service dispatcher 
“IDENT Svber000" 4 7 


COPYRIGHT (c) 1978, 1980, 1982, 1984 BY 
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASSACHUSETTS. 
ALL RIGHTS RESERVED. 


THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED 
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER 
COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY 
OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY 


TRANSFERRED. 


THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE 
oeRPORAT ok NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT 


DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS 
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 


ARAARARARALARALAAAAASELEEELELE SESE EES ERE REC ERC REESE EEE SSE E SCL OSES ESE S OES OL, 


facility: MOUNT/DISMOUNT System Services 
Abstract: 


This module contains the dispatcher for the MOUNT ard DISMOUNT 
system services, named SMOUNT and SDISMOU respectively. Both 
mount and dismout are implemented as privileged shareable images. 


the same fashion as any shareable image. 
of a privileged, shareable image is s ight ly different from that 
of an ordinary shareable image. These differences are: 


1. A vector Cot tning the entry points and providing other 
control informatio 


attribute. 

The shareable image is Linked with the /PROTECT option 
that marks all of the image sections so that they will 
proves sed and given EXEC mode ownership by the image 
activ ‘ 


The shareable image MUST be installed /SHARE /PROTECT 


~m 
° 


w 
. 


ew: 
The SMOUNT and SDISMOU system services are contained in privileged 
shareable images that are linked into user progres images in exactl 

The creation and installa 


mn to the image activator. This vector 
is a the lowest address in an image section with the VEC 
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Lion 


with the INSTALL utility in order for the image activator 
to connect the privileged shareable image to the change mode 


dispatchers. 


A privileged shareable image implementing system services is comprised 


1 
(1) 


D! 
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Page 
~SEP-1984 i) 
of the following major components: 


1. A transfer vector containing alt of the entry gotnss and 
gosh oct vas ones at the lowest virtual address in the shareable 


ae 
61; 

86 : age. T ormalism enables revision of the shareable 
65 ; image without necessitating the relinking of images that 
rt: 3 use it. 

0 96 : 2. A Privileged Library Vector in a PSECT with the VEC attribute 
67 ; that describes the entry points for dispatching EXEC and 

p 08 ; KERNEL mode services along with validation information. 

$3 : 3. A dispatcher for kernel mode services. This code will 

BS “1 3 be called by the VMS change mode dispatcher when it 

B58 i : fails to recognize a kernel mode service request. 

0090 7% : 4. A etepetcher for executive mode services. This code will 

B38 75 ; be called by the VMS change mode dispatcher when it fails 

44 6 : to recognize an executive mode service request. 

0000 78 : 5. Service routines to perform the various services. 

0000 79; 

000 9 3 

B88 1 ; Environment: 

44 : VAX/VMS operating system, installed as a privliged shareable image. 

0000 5 j-- 

000 § 3 

44 : Author: 

00 8 ; 

000 9; Steven T. Jeffreys 

0000 0; 

4 4. 3 Modified by: 

000 38 : V03-001 $1J3060 Steven T. Jeffreys 24-Feb-1983 

000 94; Set SP equal to FP before dispatching to SYSSDISMOU. 

4 95 ; This is VERY important, as high-level Languages assume this 

94 5 ; is true upon entry to a routine. 

000 98 : v02-002 $1J0203 Steven T. Jeffreys, 07-Feb-1982 

st 100 3 Add R4 to the SDISMOU register save mask. 

99 101 : v02=001 $1J0106 Steven T. Jeffreys, 18-Aug-1981 

09 : § : Removed .LIBRARY reference to SYSS$LIBRARY:LIB.MLB 

00 104 :-- 
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§ -SBTTL Declarations and Equates 
Macro Definitions 


DEFINE_SERVICE = A macro to make the agerepr tate entries in several 
different PSECTs roowirer to define an EXEC or KERNEL 


mode service. These include the transfer vector, 
the case table for dispatching, and a table containing 
the number of required arguments. 


DEFINE_SERVICE Name,Number_of_Arguments ,Mode 


.MACRO 0 FINE SERVICE ,NAME ,NARG=0 ,MODE=KERNEL 
-PSECT $SSTRARSFER_VECTOR, PAGE ,NOWRT EXE PIC 
eALIGN QUA 

* TRANSFER 


4 
0 D ; Align entry points for speed and style 
1 NAME ; Define name as universal symbol for entry | 
§ «MASK NAME, “M<R4> 3; Use entry mask defined in main routine 
. IDN MODE ,KERNEL 
: om #<KCODE BASE *KERNEL_COUNTER> ; Change to kernel mode arid execute 
; Return 
§ KERNEL _COUNTER=KERNEL_COUNTER*+1 ; Advance counter 
0 
4 
8 


-PSECT KERNEL_NARG,BYTE ,NOWRT,EXE PIC 
-BYTE  WNARG i; Define number of required arguments 


-PSECT DISMNTDSP_KERNEL _DISP1,BYTE ,NOWRT ,EXE PIC 


“WORD 2+NAME-KCASE_BASE ; Make entry in kernel mode CASE table 

 IFF 

cure #<E CODE _BASE+EXEC_COUNTER> y change to executive mode and execute 
; Return 


EXEC_COUNTER=EXEC_COUNTER+1 : Advance counter 


pore! EaE gna TS OUT EMS 6 
5 


-BYT NAR 3; Define number of required arguments 


-PSECT Boned be of EXEC_DISP1,BYTE ,NOWRT EXE ,PIC 
- WORD +NAME-ECASE_BASE ; Make entry in exec mode CASE table 


END 
-ENDM DEFINE_SERVICE 3 
3 Equated Symbols 


SooOSooSCoSSOSOSOSOSOSOOSOOSOSOOSOSOSOSOOOOOOOOOOOOOOSOOO 


OoOCOoOSCOCOCOSOOSOOOSOOSOOSOOOOSOOOOSOOOOSoOSoOO 


SOOOOSOOSOOOSOOOOoOSSSoSo 


SPLVDEF ; Detine PLV offsets and values 
SSSDEF 3; Define system status codes 


Initialize counters for change mode dispatching codes 


ERNEL_COUNTER=0 ; Kernel code counter 
XEC_COUNTER=0 3 Exec code counter 


00000000 


Own Storage 


a aa a a a aa a ana Bai aii tk a st a a an ss ss ss ss 2 ts ss 2s 1 SS 


COOOOCOOOOOOOOOOOOOOOSOOOSOOOSOOSOSOSOSOOOOOOOOOOOO 
SOOoCOCOOSOOCOSOCOOOCO COCO OOOOOOO COCO OOOO OOO OO OOOOOCOO 


-PSECT KERNEL_NARG,BYTE ,NOWRT EXE PIC cas 
ERNEL_NARG: © ; Base of byte table containing the 
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number of required arguments. 


163 : 
0000 6 18 sPSECT EXEC_NARG, BYTE ,NOWRT EXE ,PIC 
165 EXEC_NARG: ; Base of byte table containing the 
0 166 3; number of required arguments. 


c- ol er -- 
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OO 


: -SBTTL Transfer Vector and Service Definitions 


The use of transfer vectors to effect entry to the system services 

enables some upgeting of the shareable image containing sage without necessitating 
a re-link of all programs that call them. The PSECT cente ninng the transfer 
vector will be positioned at the lowest virtual address in the shareable image 

and so Long as the transfer vector is not re-ordered, programs Linked with 

one version of the shareable image will continue to work with the next. 


Thus es additional services are added to a privileged shareable image, their 
definitions should be added to the end of the following List to ensure that 
programs using prev ous versions of it will not need to be rentinkee 

o completely avoid relinking existing programs the size of the pr vileged 
shareable weoge must not change so some padding will be required to provide 
the opportunity for future growth. 


De Be Be Oe Oe Be Be Os Se Oe Se Se Se Sees 
a 


DEFINE SERVICE SYSS$DISMOU,2,KERNEL ; SOISMOU system service 


The base values used to generate the dispatching codes should be negative for 

user services and must be chosen to avoid overlap with any other privileged 
shareable images that will be used concurrently. Their definition is 

deferred to this point in the assembly to cause their use in the preceding 

macro calls to be forward references that guarantee the size of the change 

mode instructions to be four bytes. This satisfies an assumption that is 

made by for services that have to wait and be retried. The PC for retryin 

the change mode instruction that invokes the service is assumed to be 4 bytes 

less than that saved in the change mode exception frame. Of course, the particula 
service routine determines whether this is possible. 


The chenge-sode ggges available to SMOUMT and SDISMOU are the decimal values 


SOCSOS OOO OOOO OO OWW 090990908 NI NIN NINN 


WIR SO ODNOA NEW O OD NO UE WP OOO NO UNE UP 


PT FRO eo Oe Oe Oe Se Ge Be Oe Be Oe Oe Be Be Be ee 


PDE DE II ND at ast rst st st tt kk hk a 


SOoOoCoOooooooooooooooo 
CSOOooooooooooooooooood 


from 16520 to 16 
00004088 CODE _BASE=16520 ; Base CHMK code value for these services 
00000000 CODE _BASE=0 ; Base CHME code value for these services 


——e 
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5 . -SBTTL Change Mode Dispatcher Vector Block 

This vector is used by the image activator to connect the privileged shareable 
image to the VAS change mode dispatcher. The offsets in the vector are self- 
relative to enable the construction of position independent images. The system 
ersion number will be used by the image activator to verify that this shareable 
mage was Linked with the symbol table for the current system. 


Change Mode Vector Format 


+ SOT BB OS O SMSO OME DEE TT oO EMO De DOarae Dee en eon = + 


' 4 
. . 


Ferrer eowen eee neensoneseecn eee mee eo eam Ea eee + | 


3¢ 

; ; Yee tor Tyee Code !  PLVSL_TYPE 

: H (PLVSC_TYP_CMOD) ; 

PY OSes wes ecoweesnmonn masa nraon esa sone s ane nawmasaw > 

: ' System Version Number !  PLV$L_VERSION 

H H (SYS$K_VERSION) ; 

3 Ce we Sets oe SH Se SR ee Ses een eee ee wre wee wee me oe 

; Kernel Mode Dispatcher Offset } PLVSL_KERNEL 

: Exec Mode Entry Offset PLVSL_EXEC 

: eeeee ueeuamaseuonns 

; Reserved 

: Lomeemnseanuimoneneennnen eSeeeeeeaoenoenoeeneae + 

; Reserved 

: en eeeceoe eSeeeecoeeeaonoeo eseeceeeee eSeeeeeeeee a | 

3 } RMS Dispatcher Offset PLVSL_RMS 
: ¢eoeeeeeroecoeeeoecoooeos eerste on wna nena ne woe + 
: ' Address Check ! — PLVSL_CHECK 


-PSECT DISMNTDSP,PAGE,VEC,PIC,NOWRT ,EXE 


-LONG PLVSC_TYP_CMOD 
LONG SYSS$K-VERSION 
LONG KERNEC_DISPATCH-. 
- LONG XEC_OTSPATCH-. 


Set type of vector to change mode dispatch | 
Identify tysten version 

Offset to kernel mode dispatcher 

Offset to executive mode dispatcher 


MOOD NA NE WIN OS OO NAME WIN $C OOD NA NE WIN OOD NAME "OOOO 


PUD BBB BLE EF FMAM AAAI NIIPINIPOPONINININNNIND 2 PO Os Os OO 


~ LONG Reserved. 

LONG Reserved. 

LONG No RMS dispatcher 

- LONG Address check ~ PIC image 


Pe ow 
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3 aa -SBTTL Kernel Mode Dispatcher 
¢ : Input Parameters: 
3; : (SP) = Return address if bad change mode value 
33 : RO = Change mode argument value. 
61 : R4 = Current PCB Address. (Therefore R4 must be specified in all 
86 ; register save masks for kernel routines.) 
98 ; AP - Ar une nt pointer existing when the change 
o? : mo Instruct on was executed. 
85 : FP = Address of minimal call frame to exit 
oe 3 the change mode dispatcher and return to 
§ ; the original mode. 
00000000 9 F -PSECT DISMNTOSP_KERNEL_DISPO,BYTE .NOWRT EXE ,PIC 
0 i KACCVIO: 3 Kernel access violation 
50 oc 3C 0 7 MOVZWL #SS$_ACCVIO,RO 3; Set access shalt ten status code 
04 000 74 3 and return 
004 75 KINSFARG: ; Kernel insufficient arguments. 
50 0114 8F HN 44 6 MOVZWL #SSS$_INSFARG,RO 3 wet wsatue code and 
05 aoe 28 KNOTME: RSB : RSB to forward request 
08 80 KERNEL_DISPATCH:: : Entry to dispatcher 
51 BF78 £8 + 4 0 1 MOVAB W*-KCODE BASE (RO) ,R1 : Normalize dispatch code value 
F 1 1 § BLSS + ; Branch if code value too low 
01 51 B1 1 CMP + aaa COUNTER 3 Check wie Limit 
7 ' : BGEQU eNOTR ; Branch if out of range 
17 § : The dispatch code has now been verified as being handled by this dispatcher, 
17 3 now the argument List will be probed and the required number of arguments 
i 3 3 verified. 
51 Q000'CF41 9A 0017 0° MOVZBL WOKERNEL A NARGCR1),R1 ; Get required argument count 
51 00000004 9F41 ODE 19 91 MOVAL 3 goneuse byte squat including, arg count 
38 IFNORD R1,(AP),KACCVIO Branch if ara ist not readable 
BF78°CF40 6C 91 9 CMPB (AP) We <KERNEL _NARG-KCODE _BASE>CRO) heck for required number 
pi 1F 94 BLSSU KINSFAR ;" of arguments 
5E D oO 3 95 MOVL FP,SP : Set SP equal to FP 
50s AF 38 CASEW RO,- : Case on change mode 
- 3 arquaent value 
38 @KCODE BASE,- 3 Pie? value 
00 4088 8F 9 SeKERWER _COUNTER=1> 3 Limit value (number of entries 
; ? KCASE BASE: ; Case table base address for Ser INE SERVICE | 
¢ : : ase. ta le entries are made in the PSECT DISMNTDSP _KERNEL_DISP1 by 
¢ 3 s of the DEFINE SERVICE macro. The three PSECTS, 
C : 3 DISRNTDSP. MRERNEL DISPO,.1,2 will be abutted in pee order at Link-time. 
000000 § 5 -PSECT DISMNTDSP_KERNEL DISP2,BYTE, NOWRT ,EXE ,PIC 
BUG_ CHECK IVSSRVROST, FATAL : Invalid’system service request 
05 4 8 RSB™ ; Return to reject out of 
5 3; range value 
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-SBTTL Executive Mode Dispatcher 


Input Parameters: 
(SP) = Return address if bad change mode value 
RO = Change mode argument value. 


a a a ss et 


AP = ao may pointer existing when the change 
mode instruction was executed. 


FP - Address of minimal call frame to exit 
the change mode dispatcher and return to 
the original mode. 


-PSECT DISMNTDSP_EXEC_DISPO,BYTE ,NOWRT EXE ,PIC 
; 3 Exec access violation 


> 
o 
o 
< 
i md 
Oo 


4 
4 
é 
50 oc 3 8 MOVZWL #SS$_ACCVIO,RO ; Set access violation status code 
3 ET 3 _and return 
4 O EINSFARG: : Exec insufficient arguments. 
50 0114 8F . 3 1 noyew #SS$_INSFARG,RO 3 wes Sconue code and 
; _return 
05 on § ENOTME: RSB ; RSB to forward request 
5 EXEC_DISPATCH:: ; Entry to dispatcher | 
51 0000 CO 13 § MOVAB W*-ECODE_BASE(RO) ,R1 : morass ‘a9 dispatch code value | 
FB 1 1 NOTM ; Branch if code value too low 
00 51 261 1 8 CMPW R1,#EXEC_COUNTER 3 Check high Limit 
FS TE 001 33 BGEQU ENOTME ; Branch if out of range | 
17 41: The dispatch code has now been verified as being handled by this dispatcher, 
17 $s 3 now the argument List will be probed and the required number of arguments | 
i Y : verified. 
51 obey Seal 9A 17 ti MOVZBL W*EXEC_NARGCR1],R1 ; Get required argument count | 
51 00000004 9F41 ODE 19 rt) OVAL a@#4CR1J,R1 ; Compute byte count including arg count 
4 IFNORD R1,(AP),EACCVIO ; Branch arglist not readable 
0000'CF40 6C 91 8 48 PB (AP) , W*<EXEC_NARG-ECODE_BASE>CRO) ; Check for required number 
Di TF OOS 3 BLSSU EINSFARG ; of arguments | 
5E D 00 50 OVL FP,SP ; Set SP equal to FP 
50 oF 51 CASEW RO,- : Case on change mode 
2¢ = 3 argument value 
#ECODE_BASE , - ; Base value | 
FFFF 8F 00 : #<EXEC”COUNTER=1> 3; Limit value (number of entries) 
é ECASE BASE: ; Case table base address for DEFINE _SERVICE | 
C ; ; ase table entries are made in the PSECT DISMNTDSP_EXEC DISP1 by | 
¢ 3 3 nvocations of the DEF INE. ERVICE macro. The three PSECTS, 
C 3 DISMNTDSP_EXEC_DISPO,1,2 will be abutted in lexical order at Link-time. | 
0000 6 $f ' -PSECT DISMNTDSP_EXEC_DISP2,BYTE .NOWRT ,EXE PIC 
66 BUG_CHECK IVSSRVRGST,FATAL ; Invalid system service request 
05 4 ? RSB ; Return to reject out of 
; : 3 range value 
8% -END 
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ter ewroereetwmac ew oer oe ecoecw on + 


! Performance indicators ! 


- eee aS oenaenmemaieenesntinnaet 


pee on) haabaaiats 50000000 . ¥ 03 
tice BASE R 
ECODE “BASE = 
EINSFAR ft 08 
ENOTME AR 9 
EXEC_C = 0 
EXEC DISPATCH RG 
EXEC_NAR 8 
KACCVIO R | 
KCASE_BASE R ? 
KCODE BAS = 
KERNEC_COUNTER s 
KERNEL_DISPATCH RG 7 
KERNEL_NAR R $ 
KINSFARG 4 R 
KNOTME AR 07 | 
PLVSC_TYP_CMOD = 1 
A cv16 = 0000 ¢ 

SS$_INSF ARG = 0011 

SYSSD1SMOU eeereere KX 04 

SYS$K_VERSION eeeneere YX 06 

ere esemaoon ae eo 
! ; Psect synopsis ! 

PSECT name Allocation PSECT No. Attributes 

. ° 0000000 ( 0.) 0O ¢ 0.) NOPIC USR CON ABS LCL re NOEXE NORD NOWRT NOVEC BYTE 
SABS$ 0000000 ( 0.) O1¢ #1.) NOPIC USR CON ABS LCL NOSHR EXE RD WRT NOVEC BYTE 
scott. NARG 38 ( 1.) ¢ ( ¢°} PIC USR CON REL LCL NOSHR EXE RD NOWRT NOVEC BYTE 
exec C_NARG ! ( 9. . Bee PIC USR CON REL LCL NOSHR EXE RD NOWRT NOVEC BYTE 
SSTRANSTER VECTOR ( -)» 04 ¢ 4.) PIC uSR C REL LCL NOSHR EXE RD NOWRT NOVEC PAGE 
DISMNTDSP_KERNEL_DISP1 3 ( at GE Des PIC USR CON REL LCL NOSH EXE RD NOWRT NOVEC BYTE 
') ( 32.) $ ( 8: PIC USR CON REL LCL NOSHR EXE RD NOWRT VEC PAGE 
DISMNTDSP_KERNEL_DISP 0) f ( 60.) ( 7.) PIC USR CON REL LCL NOSHR EXE RD NOWRT NOVEC BYTE 
DISMNTDSP_K + RNEL-DISP 0 ( ‘a 3 ( 8°; PIC USR CON REL LCL NOSHR EXE RD NOWRT NOVEC BYTE 
DISMNTDSP_EXEC ethSy 33 3 f ( a ( 9.) PIC USR CON REL LCL NOSHR EXE RD NOWRT NOVEC BYTE 
DISMNTDSP— EXEC“ DISP 00000 ( ) A ( 10.) PIC USR CON REL LCL NOSHR’~ EXE RD NOWRT NOVEC BYTE | 


Phase Page faults CPU Time Elapsed Time 
Initialization 29 :00:00.07 :00:01 .27 | 
zonnene processing 114 :00: 4:45 :00:03.71 | 
Synbol table sort : : :00: . 

i :00: 9.99 :00:05. 
a E table output 4 :00:00. ; :00:00. 
Psect synopsis output :00:00. :00:00. 
Cross-reference output :00.00 :00:00.00 
Assembler run totals 39 . :00:25.56 
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2 
DISMNTDSP = DISMOUNT system service dis sector $ ab 242:3 cro Vv04-00 P 
VAK-11 Macro Run Statistics 4 : . 5 198 89; 18: 4} Hts OU.S REID DISMNTDSP.MAR; 1 
T rking set Limit was 1500 pages. 
IEFsh bytes te) pages) of pirtuel aonery were were a buffer she intermediate Pr: 
There were 30 pages of symbol table , Sbace al ose hold 4357 non-local he local symbols. 
*7° source Lines were read in Pass 1, produc ing ag. os ect records in Pass 
pages of ee memory were used to define macros. 


Perr sss emoeewuacer arora aa mme > 


! Macro Library statistics ! 


weno nremw nooo e nanan emaeaoane > 


Macro Library name Macros defined 


$522 8DUACE: SYS.OBJJL1B.MLB;1 
“$255$DUA SYSLIBJSTARLET.MLB;2 
TOTALS (all Libraries) 

493 GETS were required to define 7 macros. 

There were no errors, warnings or information messages. 


MACRO/LIS=L1S$:D1SMNTDSP/0BJ=0BJ$:DISMNTDSP MSRC$:D1 SMNIDSP/UPDATE=(ENHS:DISMNTDSP) +EXECMLS$/LIB 


Pew | 


0105 AH-BTi3A-SE DIGITAL EQUIPMENT CORPORATION 
Vi¥w VAX/VMS V4.0 CONFID 


ENTIAL .AND PROPRIETARY 


